home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / ingres04.lzh / doc / unix / restore.doc < prev    next >
Encoding:
Text File  |  1992-11-19  |  5.2 KB  |  108 lines
  1.  
  2.  
  3.  
  4.  
  5.      RESTORE(UNIX)                3/14/79                RESTORE(UNIX)
  6.  
  7.  
  8.  
  9.      NAME
  10.           restore - recover from an INGRES or UNIX crash.
  11.  
  12.      SYNOPSIS
  13.           _r_e_s_t_o_r_e [ -_a ] [ -_s ] [ +__w ] [ database ... ]
  14.  
  15.      DESCRIPTION
  16.           _R_e_s_t_o_r_e is used to restore a data base after  an  INGRES  or
  17.           UNIX crash.  It should always be run after any abnormal ter-
  18.           mination to ensure the integrity of the data base.
  19.  
  20.           In order to run restore, you must be the DBA for  the  data-
  21.           base  you  are restoring or the INGRES superuser and specify
  22.           the -_s flag.
  23.  
  24.           If no databases are specified then all databases  for  which
  25.           you  are  the  DBA  are restored.  All databases will be re-
  26.           stored if the INGRES superuser has specified the -_s flag.
  27.  
  28.           If the -_a flag is specified you will be asked before restore
  29.           takes any serious actions.  It is advisable to use this flag
  30.           if  you  suspect  the  database  is  in  bad  shape.   Using
  31.           /dev/null as input with the -_a flag will provide a report of
  32.           problems in the data base.  If there were  no  errors  while
  33.           restoring  a  database,  _p_u_r_g_e will be called, with the same
  34.           flags that were given to _r_e_s_t_o_r_e, to remove  unwanted  files
  35.           and  system  temporaries.  _R_e_s_t_o_r_e may be called with the -_f
  36.           and/or -_p flags for _p_u_r_g_e.  Unrecognized files  and  expired
  37.           relations are not removed unless the proper flags are given.
  38.           In the case of an incomplete destroy, create  or  index  _r_e_-
  39.           _s_t_o_r_e  will  not  delete files for partially created or des-
  40.           troyed relations.  _P_u_r_g_e must be called with the -_f flag  to
  41.           accomplish this.
  42.  
  43.           _R_e_s_t_o_r_e locks the data base while it is being processed.  If
  44.           a  data  base  is busy _r_e_s_t_o_r_e will report this and go on to
  45.           the next data base.  If standard input is not a terminal _r_e_-
  46.           _s_t_o_r_e  will  wait  for  the data base to be free.  If the -_w
  47.           flag is set _r_e_s_t_o_r_e will not wait regardless of standard in-
  48.           put.  If +_w is set it will always wait.
  49.  
  50.           _R_e_s_t_o_r_e can recover a database from an update which had fin-
  51.           ished filling the batch file.  Updates which did not make it
  52.           to this stage should be  rerun.   Similarly  modifies  which
  53.           have finished recreating the relation will be completed (the
  54.           relation relation and attribute relations will be  updated).
  55.           If  a  destroy was in progress it will be carried to comple-
  56.           tion, while a create will almost always be backed out.  Des-
  57.           troying a relation with an index should destroy the index so
  58.           _r_e_s_t_o_r_e may report that a secondary relation has been  found
  59.           with no primary.
  60.  
  61.           If interrupt (signal 2) is received the current database  is
  62.           closed  and the next, if any, is processed.  Quit (signal 3)
  63.           will cause restore to terminate.
  64.  
  65.      EXAMPLE
  66.           restore -f demo
  67.           restore -a grants < /dev/null
  68.  
  69.      DIAGNOSTICS
  70.           All diagnostics are followed by a tuple from a system  rela-
  71.           tions.
  72.  
  73.           ``No relation for attribute(s)''  -  the  attributes  listed
  74.                have no corresponding entry in the relation relation
  75.           ``No primary relation for index'' - the tuple printed is the
  76.                relation tuple for a secondary index for which there is
  77.                no primary relation.  The  primary  probably  was  des-
  78.                troyed the secondary will be.
  79.           ``No indexes entry for primary relation'' - the tuple is for
  80.                a  primary relation, the relindxd domain will be set to
  81.                zero.  This is the product of an incomplete destroy.
  82.           ``No indexes entry for index'' - the tuple is for  a  secon-
  83.                dary  index,  the index will be destroyed.  This is the
  84.                product of an incomplete destroy.
  85.           ``_r_e_l_n_a_m_e is index for'' - an index has  been  found  for  a
  86.                primary  which  is  not marked as indexed.  The primary
  87.                will be so marked.  This is probably the product of  an
  88.                incomplete  index  command.   The  index will have been
  89.                created properly but not modified.
  90.           ``No file for'' - There is no data for this relation  tuple,
  91.                the  tuple  will  be deleted.  If, under the -_a option,
  92.                the tuple is not deleted purge will not be called.
  93.           ``No secondary index for indexes entry'' - An entry has been
  94.                found  in  the indexes relation for which the secondary
  95.                index does not exist (no relation relation tuple).  The
  96.                entry will be deleted.
  97.  
  98.      SEE ALSO
  99.           purge(unix)
  100.  
  101.      BUGS
  102.           If no database names are given, only the  databases  located
  103.           in the directory _d_a_t_a/_b_a_s_e are restored, and not the old da-
  104.           tabases in _d_a_t_a_d_i_r.  Explicit database names still work  for
  105.           databases in either directory.
  106.  
  107.  
  108.